이 글에서는 애플리케이션을 다시 시작하지 않고도 애플리케이션의 로그 수준을 변경할 수 있는 방법을 공유하겠습니다.

소개

로그 수준은 일반적으로 중요도에 따라 고려됩니다. 개발에서는 "중요하지 않은" 수준(알림, 디버그 등)을 설정하고 로그 수준에서는 "가장 중요한" 수준(경고, 오류 등)만 활성화합니다. CPU 시간 및 디스크 공간과 같은 리소스가 귀중한 프로덕션입니다.

그러나 애플리케이션이 ERROR 수준에서 실행되고 많은 문제가 발생하기 시작했지만 ERROR 수준 로그에서 이를 파악할 수 없는 경우 애플리케이션을 다시 배포하여 로그 수준을 변경하는 데 많은 시간과 리소스가 소요됩니다.

게다가 프로덕션에서 INFO 또는 DEBUG 수준에서 애플리케이션을 실행하면 로깅 시스템을 압도할 수 있는 많은 수의 로그가 생성되어 I/O 작업 및 리소스 소비가 증가합니다.

이러한 문제로부터 우리를 구출하기 위해 GoFr - The Ultimate Golang Framework는 애플리케이션을 다시 시작하지 않고도 로그 수준을 변경할 수 있는 안전한 방법을 제공합니다.

로그 수준 변경

GoFr 애플리케이션의 로그 수준을 변경하려면 다음 구성이 필요합니다.

REMOTE_LOG_URL= (e.g., https://log-service.com/log-levels?id=1)

GoFr은 최신 로그 레벨을 얻기 위해 기본적으로 15초마다 제공되는 엔드포인트를 가져오며, 다음 구성을 추가하여 이 간격을 늘리거나 줄일 수 있습니다.

REMOTE_LOG_FETCH_INTERVAL= (default: 15)

로그 수준 서비스

GoFr에는 두 개의 필수 필드가 있는 다음 형식의 URL 응답이 필요합니다.

{
    "data": {
       "serviceName": "test-service",
       "logLevel": "DEBUG"
    }
}

애플리케이션에 로그 수준을 제공할 로그 수준 서비스를 만들어 보겠습니다.

GoFr을 사용하여 서비스를 만들 예정입니다. 자세한 내용은 설명서를 참조하세요.

MySQL을 데이터베이스로 사용하고 MySQL을 추가하려면 configs 디렉터리의 .env 파일에 다음 구성을 추가합니다.

DB_HOST=localhost
DB_USER=root
DB_PASSWORD=password
DB_NAME=log-level
DB_PORT=2001
DB_DIALECT=mysql

MySQL docker 컨테이너를 실행하려면 다음 명령을 실행하세요.

docker run --name gofr-logger -e MYSQL_ROOT_PASSWORD=password -e MYSQL_DATABASE=log-level -p 2001:3306 -d mysql:8.0.30

마이그레이션과 함께 main.go 파일을 추가하여 테이블을 생성하고 AddRESTHandler 기능을 사용하여 경로를 등록하겠습니다.

main.go

package main

import (
 "gofr.dev/pkg/gofr"
 "gofr.dev/pkg/gofr/migration"
)

const createTable = `CREATE TABLE level (
    id INT PRIMARY KEY,
    service_name VARCHAR(255) NOT NULL,
    log_level VARCHAR(50) NOT NULL
);
`

func createTableLevel() migration.Migrate {
 return migration.Migrate{
  UP: func(d migration.Datasource) error {
   _, err := d.SQL.Exec(createTable)
   if err != nil {
    return err
   }

   return nil
  },
 }
}

type Level struct {
 ID          int    `json:"id"`
 ServiceName string `json:"serviceName"`
 LogLevel    string `json:"logLevel"`
}

func (u *Level) RestPath() string {
 return "level"
}

func main() {
 app := gofr.New()

 app.Migrate(map[int64]migration.Migrate{1: createTableLevel()})

 err := app.AddRESTHandlers(&Level{})
 if err != nil {
  app.Logger().Fatalf("Failed to register routes for level struct: %v", err)
 }

 app.Run()
}

로그 서비스를 실행하면 다음 로그가 표시됩니다.

REST 경로가 모두 등록되었습니다.

서비스를 생성하려면 다음 요청을 보내세요.

curl --location 'localhost:8000/level' \
--header 'Content-Type: application/json' \
--data '{
    "id":1,
    "logLevel":"INFO",
    "serviceName":"gofr-app"
}'

로그 수준을 업데이트하려면 다음 요청을 보내세요.

curl --location --request PUT 'localhost:8000/level/1' \
--header 'Content-Type: application/json' \
--data '{
    "id":1,
    "logLevel":"DEBUG",
    "serviceName":"gofr-app"
}'

로그 수준을 가져오려면 다음 요청을 보내세요.

curl --location 'localhost:8000/level/1'

동일한 URL은 로그 수준을 원격으로 변경해야 하는 애플리케이션의 구성에 사용됩니다.

결론

GoFr 원격 로그 수준 변경 기능을 사용하면 다음과 같은 이점을 얻을 수 있습니다.

• 손쉬운 조정:
  애플리케이션을 다시 시작하지 않고도 언제든지 로그 수준을 수정할 수 있습니다. 이는 문제 해결 중에 특히 유용합니다.

• 가시성 향상:
  더 자세한 로그 수준(예: DEBUG)으로 쉽게 전환하여 특정 문제에 대한 더 깊은 통찰력을 얻은 다음, 일반 작업을 위해 덜 자세한 수준(예: INFO)으로 다시 전환하세요.

• 향상된 성능:
  많은 수의 로그를 생성하면 로깅 시스템에 부담을 주어 I/O 작업 및 리소스 소비가 증가할 수 있습니다. 경고 또는 오류 수준으로 변경하면 로그 수가 줄어들고 성능이 향상되며 클라우드 비용이 절감됩니다.

별표를 주어 GoFr을 지원하세요: https://github.com/gofr-dev/gofr

또한 무료 공개 엔드포인트에 액세스하여 애플리케이션의 추적을 내보내고 볼 수 있습니다 @tracer.gofr.dev. 
이를 활성화하려면 .env 파일에 다음 구성을 추가하세요

TRACE_EXPORTER=gofr

다른 이익:
개발이나 기사 작성 시 GOFR에 기여하는 경우. GitHub Readme(하단)에 제시된 양식을 작성하면 무료 스웨그(티셔츠, 스티커)